home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / TeX / README < prev    next >
Text File  |  1994-08-01  |  7KB  |  157 lines
  1.  
  2.                     ~4Dgifts/toolbox/public/TeX README
  3.  
  4.          See also the TeX Frequently Asked Questions file located at
  5.                   ~4Dgifts/toolbox/FAQs/netfaqs/tex-faq
  6.  
  7.    NOTE:  in v4.2 space constraints forced a change of plan.  the .tar files
  8.           in the TeX distribution are not included an this CD.  they have not
  9.           changed since v4.1 and so, everyone who receives the v4.2 CD will
  10.           already have or will recieve the v4.1 CD as well so all will have
  11.           all the "bits".  the daze of having everything in the D.T. fit onto 
  12.           one CD are over.  explorations are in progress for ways to grow
  13.           this resource.
  14.  
  15.  
  16.    This incarnation of TeX built for IRIX 5.2, exists solely because of the
  17.    efforts of Chuck Adams.  Mr. Adams cranked this out on his own time while
  18.    holding down a maxed-out teaching position for SGI in Dallas.  It is with
  19.    grrrrrreat appreciation to Chuck that this stuff exists.
  20.  
  21.  
  22.  
  23.    TeX is a public domain text processing system.  It was developed by
  24.    Donald Knuth at Stanford University, and is made freely available
  25.    without license.  TeX is a large and complicated program that goes
  26.    to extraordinary lengths to produce attractive typeset material.
  27.    However, straightforward text is very easy to typeset using \TeX\null.
  28.    So it's possible to start with easier text and work up to more
  29.    complicated situations.  The document, GENTLE_INTRO.TEX, is included
  30.    in the "texfiles.tar" file.  Instructions explaining how produce the
  31.    manual are included below.
  32.    
  33.    Included with this distribution is LaTeX -- which, in fact, is a macro 
  34.    package built on top of TeX (it is pronounced and written similarly to 
  35.    TeX, but proceeded by either `lay' or `lah', according to individual 
  36.    preference).  The LaTeX macros were written by Leslie Lamport.  LaTeX 
  37.    capabilities and language are described in "LaTeX:  A Document 
  38.    Preparation System", by Leslie Lamport, Addison-Wesley Publishing 
  39.    Company, ISBN 0-201-15790.
  40.  
  41.  
  42.    The installation of TeX requires approximately 10 Mbytes of permanent
  43.    space on your /usr disk (for the executables and other files), as well
  44.    as approximately 100 Mbytes of scratch space for installation from
  45.    the source.  The scratch space can be on any available disk.  The 
  46.    installation script can be run directly from the CD-ROM.
  47.  
  48.    To run this installation script, you must first specify the path
  49.    of a directory for the scratch space (eg., /usr/tmp).  A temporary
  50.    directory will be created within that directory called "TeX_install".
  51.    After the installation is completed successfully, you should remove
  52.    "TeX_install" directory and all subdirectories.
  53.  
  54.    Be sure that you have write access to the installation directory.
  55.    If the directory you want to use for this purpose is remotely mounted,
  56.    make sure you have write access to that disk by checking the /etc/exports
  57.    file on the remote machine.  For instance, if you want to use the
  58.    directory, /d/tmp, on a machine named wally, then the /etc/exports
  59.    file on wally should include a line that looks something like this:
  60.    "/d -rw ...".  If the "-rw" option is not included, add it, and
  61.    then (as "root" on wally) execute the command, "exportfs -a".
  62.  
  63.    To begin the installaion of TeX, specify the installation directory
  64.    by typing:
  65.  
  66.         setenv INSTALL_DIR /a/directory/path
  67.  
  68.    Because of the large amount of information generated by the
  69.    installation procedure, it's best to save the output into a file.
  70.  
  71.    To execute the installation script, type:
  72.  
  73.         su
  74.         (time ./makeTeX) >& /usr/tmp/maketex.out &
  75.  
  76.    Note that you must execute "makeTeX" from the directory where it resides,
  77.    and that "root" permission is required.  The installation takes
  78.    approximately 35 minutes on a 4D/35.  The metafont generation takes
  79.    most of this time.
  80.  
  81.    To view the installation output, use fold to convert all lines in 
  82.    makeout.out that are greater 80 characters to get a line-feed inserted 
  83.    after the modulo-80th-character by doing:
  84.  
  85.         cd /usr/tmp
  86.         fold maketex.out > tmp
  87.         mv tmp maketex.out
  88.         more maketex.out
  89.  
  90.    In "maketex.out", you will find some errors and lots warnings.  
  91.    Several installs get warnings from the loader about duplicate modules, 
  92.    but I didn't take the time to thoroughly investigate (ignore these).  
  93.    Also, several of the man pages were attempting to move to BSD 
  94.    directories (not SYSV).  See the file maketex.out.sample for an actual
  95.    installation we did in the testing-phase of version 4.1 of the Developer
  96.    Toolbox CD.
  97.     
  98.    If you don't find any glaring errors, move to the $INSTALL_DIR/TeX_install
  99.    directory and extract the files from the "texfiles.tar" file with the
  100.    command:
  101.  
  102.         tar xvof texfiles.tar
  103.  
  104.    This will create a "texfiles" directory containing the two files,
  105.    gentle.ps and gentle.tex.
  106.  
  107.    To test the software, log in as a regular user (not as "root") and
  108.    set the following environment variables:
  109.  
  110.         setenv TEXFONTS /usr/local/lib/tex/fonts/pk/laserwriter:/usr/local/lib/tex/fonts/tfm
  111.         setenv TEXINPUTS .:/usr/local/lib/tex/inputs
  112.         setenv TEXPKS /usr/local/lib/tex/fonts/pk/laserwriter
  113.  
  114.    If you'll be using TeX frequently, add the above lines to your .cshrc
  115.    file and to those users requiring frequent usage.
  116.  
  117.    Now do the following:
  118.         tex gentle.tex
  119.         dvips gentle.dvi
  120.  
  121.    This should create a "gentle.ps" file, which is a PostScript document
  122.    containing the TeX manual.  The manual is 95 pages long.  This will
  123.    verify that the package did install correctly.
  124.  
  125.    NOTE:  ALL files resident inside the *.tar images are listed in the
  126.       contents.tar.list file.
  127.  
  128.    Finally, after you are satisfied that the installation was successful,
  129.    save the "texfiles" directory, and after looking around at the additional
  130.    directories for any useful programs, data, examples, etc., remove the
  131.    $INSTALL_DIR/TeX_install directory.
  132.  
  133.  
  134.    ------------------------------------------------------------------------
  135.  
  136.  
  137.    If your IRIS workstation has the EOE (Execution-Only-Environment) system
  138.    software installed, you may still install TeX.  To do this, log in as
  139.    "root" and extract the executables by typing the command:
  140.  
  141.         tar xvof tarfiles.for.4.0
  142. or 
  143.         tar xvof tarfiles.for.5.2
  144.  
  145. where tarfiles.for.4.0 is for systems running versions of IRIX 4.X
  146. and   tarfiles.for.5.2 is for systems running version of IRIX 5.1 or higher.
  147.  
  148.    This will give you all the binaries in /usr/local that are needed
  149.    to run TeX.  These were created using IRIX 4.X or 5.X, so they will not
  150.    work if you are running an OS other than these, but you can create the
  151.    sources for the tar files and compile under your current O/S release
  152.    as describe above using makeTeX.
  153.  
  154.  
  155.    ------------------------------------------------------------------------
  156.  
  157.